home *** CD-ROM | disk | FTP | other *** search
/ MacAddict Special 2004: T…timate How-To Collection / MacAddict SPECIAL 2004 Ultimate How to Collection.toast / FTP for Free / Fetch 4.0.3 trial / Fetch Example Scripts / FetchAE.cp next >
Encoding:
Text File  |  2001-05-01  |  24.4 KB  |  937 lines
  1. /*
  2.      FetchAE.cp -- sample Apple Event code for Fetch
  3.      
  4.      Copyright © 1996, Trustees of Dartmouth College
  5.      Copyright (c) 2001, Fetch Softworks
  6.      All Rights Reserved.
  7.      
  8.      Distribution and use of this code is hereby permitted, provided that any resulting
  9.      work includes the copyright statement above.
  10. */
  11.  
  12. #include <string.h>
  13.  
  14. #include <AEObjects.h>
  15. #include <AEPackObject.h>
  16.  
  17. #include "FetchAE.h"
  18.  
  19. static void InitDesc(AEDesc *desc);
  20. static void DisposeDesc(AEDesc *desc);
  21. static void CStringToDesc(char *valuep, DescType dType, AEDesc *desc);
  22. static void DescTypeToDesc(OSType value, DescType dType, AEDesc *desc);
  23. static void LongToDesc(long value, DescType dType, AEDesc *desc);
  24. static void FSSpecToDesc(FSSpec *valuep, DescType dType, AEDesc *desc);
  25. static Boolean findProcessBySignature(OSType sig, ProcessSerialNumber *psn_p, long *proc_mode_p);
  26. static Boolean findAppBySignature(OSType sig, FSSpec *fspec_p);
  27. static OSErr InitAEToApp(OSType appSig, AEEventClass eventClass, AEEventID eventID, 
  28.             AppleEvent *aevt, Boolean *running);
  29. static OSErr SendAEToApp(OSType appSig, AppleEvent *aevt, AppleEvent *aereply, AEIdleUPP idleUPP, Boolean running);
  30. static OSErr SendDirectAppleEvent(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  31.                 AEDesc *directDesc, AppleEvent *aereply, AEIdleUPP idleUPP);
  32. static OSErr SendDirectAppleEventWithArg(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  33.                 AEDesc *directDesc, AEKeyword argKey, AEDesc *argDesc,
  34.                 AppleEvent *aereply, AEIdleUPP idleUPP);
  35. static OSErr SendDirectAppleEventWithThreeArgs(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  36.                 AEDesc *directDesc, AEKeyword argKey, AEDesc *argDesc,
  37.                 AEKeyword arg2Key, AEDesc *arg2Desc,
  38.                 AEKeyword arg3Key, AEDesc *arg3Desc,
  39.                 AppleEvent *aereply, AEIdleUPP idleUPP);
  40. static OSErr SendCreateAppleEvent(OSType appSig, DescType objClass, AEDesc *insertLocDesc,
  41.                 AEDesc *dataDesc, AEDesc *propDesc, 
  42.                 AppleEvent *aereply, AEIdleUPP idleUPP);
  43. static OSErr SendMoveCloneAppleEvent(OSType appSig, AEEventID eventID, AEDesc *directDesc, 
  44.                 AEDesc *insertLocDesc, AppleEvent *aereply, AEIdleUPP idleUPP);
  45. static OSErr CreateFormNameOSpec(char *name, DescType objClass, AEDesc *containerDesc, AEDesc *ospecDesc);
  46. static OSErr CreatePropertyOSpec(DescType propCode, AEDesc *containerDesc, AEDesc *ospecDesc);
  47.  
  48. /*
  49.  * InitDesc() --
  50.  *    Initialize a descriptor.
  51.  */
  52. void InitDesc(AEDesc *desc)
  53. {
  54.     desc->descriptorType = typeNull;
  55.     desc->dataHandle = nil;
  56. }
  57.  
  58. /*
  59.  * DisposeDesc() --
  60.  *    Dispose of descriptor data and mark descriptor as empty.
  61.  */
  62. void DisposeDesc(AEDesc *desc)
  63. {
  64.     if (desc->dataHandle != nil)
  65.         (void) AEDisposeDesc(desc);
  66.     InitDesc(desc);
  67. }
  68.  
  69. /*
  70.  * CStringToDesc() -- 
  71.  *    Put a C string into a descriptor record.
  72.  */
  73. void CStringToDesc(char *valuep, DescType dType, AEDesc *desc)
  74. {
  75.     desc->descriptorType = dType;
  76.     if (dType == typeChar)
  77.         (void) PtrToHand(valuep, &desc->dataHandle, strlen(valuep));
  78.     else if (dType == typeIntlText)
  79.     {
  80.         desc->dataHandle = NewHandle(4+valuep[0]);
  81.         *(short *) *desc->dataHandle = smRoman;
  82.         *(short *) (*desc->dataHandle + 2) = langEnglish;
  83.         BlockMoveData(valuep, *desc->dataHandle + 4, strlen(valuep));
  84.     }
  85.     else
  86.         InitDesc(desc);
  87. } /* CStringToDesc() */
  88.  
  89. /*
  90.  * DescTypeToDesc() -- 
  91.  *    Put an OSType into a descriptor record.
  92.  */
  93. void DescTypeToDesc(OSType value, DescType dType, AEDesc *desc)
  94. {
  95.     desc->descriptorType = dType;
  96.     (void) PtrToHand(&value, &desc->dataHandle, sizeof(value));
  97. } /* DescTypeToDesc() */
  98.  
  99. /*
  100.  * LongToDesc() -- 
  101.  *    Put a longint into a descriptor record.
  102.  */
  103. void LongToDesc(long value, DescType dType, AEDesc *desc)
  104. {
  105.     desc->descriptorType = dType;
  106.     if (dType == typeLongDateTime)
  107.     {
  108.         desc->dataHandle = NewHandle(8);
  109.         *(long *) *desc->dataHandle = 0;
  110.         *(long *) (*desc->dataHandle + 4) = value;
  111.     }
  112.     else
  113.         (void) PtrToHand(&value, &desc->dataHandle, sizeof(value));
  114. } /* LongToDesc() */
  115.  
  116. /*
  117.  * FSSpecToDesc() -- 
  118.  *    Put a File System Spec into a descriptor record.
  119.  */
  120. void FSSpecToDesc(FSSpec *valuep, DescType dType, AEDesc *desc)
  121. {
  122.     OSErr    osstat;
  123.     
  124.     desc->descriptorType = dType;
  125.     if (dType == typeFSS)
  126.         (void) PtrToHand(valuep, &desc->dataHandle, sizeof(FSSpec));
  127.     else if (dType == typeAlias)
  128.     {
  129.         osstat = NewAlias(nil, valuep, (AliasHandle *) &desc->dataHandle);
  130.         if (osstat != noErr)
  131.             InitDesc(desc);
  132.     }
  133.     else
  134.         InitDesc(desc);
  135. } /* FSSpecToDesc() */
  136.  
  137. /*
  138.  * findProcessBySignature() -- 
  139.  *    Find a running process based on its signature
  140.  *    See IM-VI 29-11 
  141.  */
  142. Boolean findProcessBySignature(OSType sig, ProcessSerialNumber *psn_p, long *proc_mode_p)
  143. {
  144.     ProcessInfoRec        procInfo;
  145.  
  146.     psn_p->highLongOfPSN = 0;
  147.     psn_p->lowLongOfPSN = kNoProcess;
  148.     
  149.     procInfo.processInfoLength = sizeof(procInfo);
  150.     procInfo.processName = NULL;
  151.     procInfo.processAppSpec = NULL;
  152.     
  153.     while (GetNextProcess(psn_p) == noErr)
  154.         if (GetProcessInformation(psn_p, &procInfo) == noErr)
  155.             if ((procInfo.processType == 'APPL') &&
  156.                 (procInfo.processSignature == sig))
  157.             {
  158.                 *proc_mode_p = procInfo.processMode;
  159.                 return true;
  160.             }
  161.                 
  162.     return false;
  163. } /* findProcessBySignature() */
  164.  
  165. /*
  166.  * findAppBySignature() -- 
  167.  *    Use the desktop database to find an app with this sig on a mounted volume.
  168.  */
  169. Boolean findAppBySignature(OSType sig, FSSpec *fspec_p)
  170. {
  171.     ParamBlockRec        pb;
  172.     HParamBlockRec        hpb;
  173.     GetVolParmsInfoBuffer    volParms;
  174.     DTPBRec            dtpb;
  175.     OSErr            osstat;
  176.  
  177.     /* for each volume */
  178.     pb.volumeParam.ioCompletion = NULL;
  179.     pb.volumeParam.ioNamePtr = NULL;
  180.     pb.volumeParam.ioVRefNum = 0;
  181.     pb.volumeParam.ioVolIndex = 1;
  182.     osstat = PBGetVInfo(&pb, false);
  183.     while (osstat == noErr)
  184.     {
  185.         /* check to see if it supports the desktop manager */
  186.         hpb.ioParam.ioCompletion = NULL;
  187.         hpb.ioParam.ioVRefNum = pb.volumeParam.ioVRefNum;
  188.         hpb.ioParam.ioNamePtr = NULL;
  189.         hpb.ioParam.ioBuffer = (Ptr) &volParms;
  190.         hpb.ioParam.ioReqCount = sizeof(volParms);
  191.         osstat = PBHGetVolParms(&hpb, false);
  192.         if ((osstat == noErr) && (volParms.vMAttrib & (1 << bHasDesktopMgr)))
  193.         {
  194.             /* find out the Desktop reference number */
  195.             dtpb.ioNamePtr = NULL;
  196.             dtpb.ioVRefNum = pb.volumeParam.ioVRefNum;
  197.             osstat = PBDTGetPath(&dtpb);
  198.             if (osstat == noErr)
  199.             {
  200.                 /* search this Desktop database for an app with the right signature */
  201.                 dtpb.ioCompletion = NULL;
  202.                 dtpb.ioNamePtr = (StringPtr) &(fspec_p->name);
  203.                 dtpb.ioIndex = 0;
  204.                 dtpb.ioFileCreator = sig;
  205.                 osstat = PBDTGetAPPL(&dtpb, false);
  206.                 if (osstat == noErr)
  207.                 {
  208.                     /* found the app */
  209.                     fspec_p->vRefNum = pb.volumeParam.ioVRefNum;
  210.                     fspec_p->parID = dtpb.ioAPPLParID;
  211.                     return true;
  212.                 } /* PBDTGetAPPL == noErr */
  213.             } /* PBDTGetPath == noErr */
  214.         } /* PBHGetVolParms == noErr */
  215.     
  216.         pb.volumeParam.ioVolIndex++;
  217.         osstat = PBGetVInfo(&pb, false);
  218.     } /* while PBGetVInfo == noErr */
  219.     
  220.     return false;
  221. } /* findAppBySignature() */
  222.  
  223. /*
  224.  * InitAEToApp() -- 
  225.  *    Initialize an apple event to be sent to an application.  Return the event, and
  226.  *    whether the application is currently running.
  227.  */
  228. OSErr InitAEToApp(OSType appSig, AEEventClass eventClass, AEEventID eventID, 
  229.             AppleEvent *aevt, Boolean *running)
  230. {
  231.     AEDesc            addrDesc;
  232.     ProcessSerialNumber    psn;
  233.     long            dummy;
  234.     OSErr            osstat;
  235.  
  236.     InitDesc(&addrDesc);
  237.     osstat = noErr;
  238.     
  239.     *running = findProcessBySignature(appSig, &psn, &dummy);
  240.     if (*running)
  241.         osstat = AECreateDesc(typeProcessSerialNumber, &psn, sizeof(psn), &addrDesc);
  242.     else
  243.         osstat = AECreateDesc(typeApplSignature, &appSig, sizeof(OSType), &addrDesc);
  244.     if (osstat != noErr) 
  245.         goto exit;
  246.     
  247.     osstat = AECreateAppleEvent(eventClass, eventID, &addrDesc, 
  248.                 kAutoGenerateReturnID, kAnyTransactionID,
  249.                 aevt);
  250. exit:
  251.     DisposeDesc(&addrDesc);
  252.     return osstat;
  253. } /* InitAEToApp() */
  254.  
  255. /*
  256.  * SendAEToApp() --
  257.  *    Send an Apple Event to an application, which may or may not be running.  If it isn't
  258.  *    running, the event reply won't be filled in....
  259.  */
  260. OSErr SendAEToApp(OSType appSig, AppleEvent *aevt, AppleEvent *aereply, AEIdleUPP idleUPP, Boolean running)
  261. {
  262.     LaunchParamBlockRec    lpb;
  263.     AEDesc            appParmDesc;
  264.     AEDesc            replyDesc;
  265.     AppleEvent        myreply;
  266.     AppleEvent        *replyp;
  267.     FSSpec            appFspec;
  268.     OSErr            osstat = noErr;
  269.     
  270.     InitDesc(&appParmDesc);
  271.     InitDesc(&myreply);
  272.     InitDesc(&replyDesc);
  273.     
  274.     if (running)
  275.     {
  276.         /* the app is running, just send the event */
  277.         replyp = aereply ? aereply : &myreply;
  278.         osstat = AESend(aevt, replyp, kAEWaitReply + kAECanInteract + kAECanSwitchLayer + kAEDontReconnect,
  279.                 kAENormalPriority, kAEDefaultTimeout, idleUPP, nil);
  280.         if (osstat == -603)
  281.             /* ignore this error, it doesn't seem to matter */
  282.             osstat = noErr;
  283.         if (osstat == noErr)
  284.         {
  285.             osstat = AEGetParamDesc(replyp, keyErrorNumber, typeLongInteger, &replyDesc);
  286.             if (osstat == noErr)
  287.                 osstat = **(long **) replyDesc.dataHandle;
  288.             else if (osstat == errAEDescNotFound)
  289.                 /* no error code, no error */
  290.                 osstat = noErr;
  291.         }
  292.     } // running
  293.     else if (findAppBySignature(appSig, &appFspec))
  294.     {
  295.         /* we need to launch the app with the event */
  296.         osstat = AECoerceDesc(aevt, typeAppParameters, &appParmDesc);
  297.         if (osstat != noErr)
  298.             goto exit;
  299.         
  300.         HLock(appParmDesc.dataHandle);
  301.         
  302.         /* call LaunchApplication */
  303.         lpb.launchBlockID = extendedBlock;
  304.         lpb.launchEPBLength = extendedBlockLen;
  305.         lpb.launchFileFlags = launchNoFileFlags;
  306.         lpb.launchControlFlags = launchContinue + launchDontSwitch;
  307.         lpb.launchAppSpec = &appFspec;
  308.         lpb.launchAppParameters = (AppParametersPtr) *appParmDesc.dataHandle;
  309.         THz    oldZone = GetZone();
  310.         osstat = LaunchApplication(&lpb);
  311.         if (osstat == -603)
  312.             /* ignore this error, it doesn't seem to matter */
  313.             osstat = noErr;
  314.         SetZone(oldZone);
  315.     } // findAppBySignature()
  316.     else
  317.         /* app can't be found */
  318.         osstat = fnfErr;
  319.  
  320. exit:
  321.     DisposeDesc(&appParmDesc);
  322.     DisposeDesc(&myreply);
  323.     DisposeDesc(&replyDesc);
  324.     return osstat;
  325. } /* SendAEToApp() */
  326.  
  327. /*
  328.  * SendDirectAppleEvent() -- 
  329.  *    Send a simple event w/ just a direct parameter.
  330.  */
  331. OSErr SendDirectAppleEvent(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  332.                 AEDesc *directDesc, AppleEvent *aereply, AEIdleUPP idleUPP)
  333. {
  334.     AppleEvent    aevt;
  335.     OSErr        osstat;
  336.     Boolean        running;
  337.  
  338.     InitDesc(&aevt);
  339.     osstat = noErr;
  340.     
  341.     /* create the event */
  342.     osstat = InitAEToApp(appSig, eventClass, eventID, &aevt, &running);
  343.     if (osstat != noErr) 
  344.         goto exit;
  345.         
  346.     /* add direct object */
  347.     osstat = AEPutParamDesc(&aevt, keyDirectObject, directDesc);
  348.     if (osstat != noErr) 
  349.         goto exit;
  350.         
  351.     /* send the event */
  352.     osstat = SendAEToApp(appSig, &aevt, aereply, idleUPP, running);
  353.     
  354. exit:
  355.     DisposeDesc(&aevt);
  356.     return osstat;
  357. } /* SendDirectAppleEvent */
  358.  
  359. /*
  360.  * SendDirectAppleEventWithArg() -- 
  361.  *    Send a simple event w/ a direct parameter and one other argument.
  362.  */
  363. OSErr SendDirectAppleEventWithArg(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  364.                 AEDesc *directDesc, AEKeyword argKey, AEDesc *argDesc,
  365.                 AppleEvent *aereply, AEIdleUPP idleUPP)
  366. {
  367.     AppleEvent    aevt;
  368.     OSErr        osstat;
  369.     Boolean        running;
  370.  
  371.     InitDesc(&aevt);
  372.     osstat = noErr;
  373.     
  374.     /* create the event */
  375.     osstat = InitAEToApp(appSig, eventClass, eventID, &aevt, &running);
  376.     if (osstat != noErr) 
  377.         goto exit;
  378.         
  379.     /* add direct object */
  380.     osstat = AEPutParamDesc(&aevt, keyDirectObject, directDesc);
  381.     if (osstat != noErr) 
  382.         goto exit;
  383.         
  384.     /* add argument */
  385.     osstat = AEPutParamDesc(&aevt, argKey, argDesc);
  386.     if (osstat != noErr) 
  387.         goto exit;
  388.         
  389.     /* send the event */
  390.     osstat = SendAEToApp(appSig, &aevt, aereply, idleUPP, running);
  391.     
  392. exit:
  393.     DisposeDesc(&aevt);
  394.     return osstat;
  395. } /* SendDirectAppleEventWithArg */
  396.  
  397. /*
  398.  * SendDirectAppleEventWithThreeArgs() -- 
  399.  *    Send ourselves an event w/ a direct parameter and three other arguments.
  400.  */
  401. OSErr SendDirectAppleEventWithThreeArgs(OSType appSig, AEEventClass eventClass, AEEventID eventID,
  402.                 AEDesc *directDesc, AEKeyword argKey, AEDesc *argDesc,
  403.                 AEKeyword arg2Key, AEDesc *arg2Desc,
  404.                 AEKeyword arg3Key, AEDesc *arg3Desc,
  405.                 AppleEvent *aereply, AEIdleUPP idleUPP)
  406. {
  407.     AppleEvent    aevt;
  408.     OSErr        osstat;
  409.     Boolean        running;
  410.  
  411.     InitDesc(&aevt);
  412.     osstat = noErr;
  413.     
  414.     /* create the event */
  415.     osstat = InitAEToApp(appSig, eventClass, eventID, &aevt, &running);
  416.     if (osstat != noErr) 
  417.         goto exit;
  418.         
  419.     /* add direct object */
  420.     osstat = AEPutParamDesc(&aevt, keyDirectObject, directDesc);
  421.     if (osstat != noErr) 
  422.         goto exit;
  423.         
  424.     /* add arguments */
  425.     osstat = AEPutParamDesc(&aevt, argKey, argDesc);
  426.     if (osstat != noErr) 
  427.         goto exit;
  428.     osstat = AEPutParamDesc(&aevt, arg2Key, arg2Desc);
  429.     if (osstat != noErr) 
  430.         goto exit;
  431.     osstat = AEPutParamDesc(&aevt, arg3Key, arg3Desc);
  432.     if (osstat != noErr) 
  433.         goto exit;
  434.                 
  435.     /* send the event */
  436.     osstat = SendAEToApp(appSig, &aevt, aereply, idleUPP, running);
  437.     
  438. exit:
  439.     DisposeDesc(&aevt);
  440.     return osstat;
  441. } /* SendDirectAppleEventWithThreeArgs */
  442.  
  443. /*
  444.  * SendCreateAppleEvent() -- 
  445.  *    Send a Create Element event.
  446.  */
  447. OSErr SendCreateAppleEvent(OSType appSig, DescType objClass, AEDesc *insertLocDesc,
  448.                 AEDesc *dataDesc, AEDesc *propDesc, 
  449.                 AppleEvent *aereply, AEIdleUPP idleUPP)
  450. {
  451.     AppleEvent    aevt;
  452.     OSErr        osstat;
  453.     Boolean        running;
  454.  
  455.     InitDesc(&aevt);
  456.     osstat = noErr;
  457.     
  458.     /* create the event */
  459.     osstat = InitAEToApp(appSig, kAECoreSuite, kAECreateElement, &aevt, &running);
  460.     if (osstat != noErr) 
  461.         goto exit;
  462.         
  463.     /* add desired class */
  464.     osstat = AEPutParamPtr(&aevt, keyAEObjectClass, typeType, &objClass, 
  465.                             sizeof(objClass));
  466.     if (osstat != noErr)
  467.         goto exit;
  468.         
  469.     /* add insertion location */
  470.     osstat = AEPutParamDesc(&aevt, keyAEInsertHere, insertLocDesc);
  471.     if (osstat != noErr) 
  472.         goto exit;
  473.         
  474.     /* add initial data, if (there is some */
  475.     if (dataDesc && (dataDesc->descriptorType != typeNull))
  476.     {
  477.         osstat = AEPutParamDesc(&aevt, keyAEData, dataDesc);
  478.         if (osstat != noErr)
  479.             goto exit;
  480.     }
  481.     
  482.     /* add initial property values, if (there are some */
  483.     if (propDesc && (propDesc->descriptorType != typeNull))
  484.     {
  485.         osstat = AEPutParamDesc(&aevt, keyAEPropData, propDesc);
  486.         if (osstat != noErr)
  487.             goto exit;
  488.     }
  489.     
  490.     /* send the event */
  491.     osstat = SendAEToApp(appSig, &aevt, aereply, idleUPP, running);
  492.     
  493. exit:
  494.     DisposeDesc(&aevt);
  495.     return osstat;
  496. } /* SendCreateAppleEvent() */
  497.  
  498. /*
  499.  * SendMoveCloneAppleEvent() -- 
  500.  *    Send a Move or Clone event.
  501.  */
  502. OSErr SendMoveCloneAppleEvent(OSType appSig, AEEventID eventID, AEDesc *directDesc, 
  503.                 AEDesc *insertLocDesc, AppleEvent *aereply, AEIdleUPP idleUPP)
  504. {
  505.     AppleEvent    aevt;
  506.     OSErr        osstat;
  507.     Boolean        running;
  508.  
  509.     InitDesc(&aevt);
  510.     osstat = noErr;
  511.     
  512.     /* create the event */
  513.     osstat = InitAEToApp(appSig, kAECoreSuite, eventID, &aevt, &running);
  514.     if (osstat != noErr) 
  515.         goto exit;
  516.         
  517.     /* add direct object */
  518.     osstat = AEPutParamDesc(&aevt, keyDirectObject, directDesc);
  519.     if (osstat != noErr) 
  520.         goto exit;
  521.         
  522.     /* add insertion location */
  523.     osstat = AEPutParamDesc(&aevt, keyAEInsertHere, insertLocDesc);
  524.     if (osstat != noErr) 
  525.         goto exit;
  526.         
  527.     /* send the event */
  528.     osstat = SendAEToApp(appSig, &aevt, aereply, idleUPP, running);
  529.     
  530. exit:
  531.     DisposeDesc(&aevt);
  532.     return osstat;
  533. } /* SendMoveCloneAppleEvent() */
  534.  
  535. /* 
  536.  * CreateFormNameOSpec() --
  537.  *    Create a formName object specifier.
  538.  */
  539. OSErr CreateFormNameOSpec(char *name, DescType objClass, AEDesc *containerDesc, AEDesc *ospecDesc)
  540. {
  541.     AEDesc    keyDesc;
  542.     AEDesc    nullDesc;
  543.     
  544.     InitDesc(&keyDesc);
  545.     InitDesc(&nullDesc);
  546.     CStringToDesc(name, typeChar, &keyDesc);
  547.     OSErr    osstat = CreateObjSpecifier(objClass, containerDesc ? containerDesc : &nullDesc, 
  548.                         formName, &keyDesc, false, ospecDesc);
  549.     DisposeDesc(&keyDesc);
  550.     return osstat;
  551. } // CreateFormNameOSpec()
  552.  
  553. /* 
  554.  * CreatePropertyOSpec() --
  555.  *    Create a formPropertyID object specifier.
  556.  */
  557. OSErr CreatePropertyOSpec(DescType propCode, AEDesc *containerDesc, AEDesc *ospecDesc)
  558. {
  559.     AEDesc    keyDesc;
  560.     AEDesc    nullDesc;
  561.     
  562.     InitDesc(&keyDesc);
  563.     InitDesc(&nullDesc);
  564.     DescTypeToDesc(propCode, typeType, &keyDesc);
  565.     OSErr    osstat = CreateObjSpecifier(cProperty, containerDesc ? containerDesc : &nullDesc, 
  566.                         formPropertyID, &keyDesc, false, ospecDesc);
  567.     DisposeDesc(&keyDesc);
  568.     return osstat;
  569. } // CreatePropertyOSpec()
  570.  
  571. /*
  572.  * FetchOpenURL() --
  573.  *    Tell Fetch to open a directory (specified by a URL).
  574.  */
  575. OSErr FetchOpenURL(char *url, AEIdleUPP idleUPP)
  576. {
  577.     AEDesc    urlDesc;
  578.     OSErr    osstat = noErr;
  579.     
  580.     InitDesc(&urlDesc);
  581.     osstat = CreateFormNameOSpec(url, cURL, nil, &urlDesc);
  582.     if (osstat == noErr)
  583.         osstat = SendDirectAppleEvent(FETCH_APP_SIGNATURE, kCoreEventClass, kAEOpen, &urlDesc,
  584.                         nil, idleUPP);
  585.     DisposeDesc(&urlDesc);
  586.     return osstat;
  587. } // FetchOpenURL()
  588.  
  589.  
  590. /*
  591.  * FetchPut() --
  592.  *    Tell Fetch to upload a file or folder to a URL
  593.  */
  594. OSErr FetchPut(FSSpec *fspec, char *url, AEIdleUPP idleUPP)
  595. {
  596.     AEDesc    urlDesc;
  597.     AEDesc    fspecDesc;
  598.     OSErr    osstat = noErr;
  599.     
  600.     InitDesc(&urlDesc);
  601.     InitDesc(&fspecDesc);
  602.     
  603.     osstat = CreateFormNameOSpec(url, cURL, nil, &urlDesc);
  604.     if (osstat != noErr)
  605.         goto exit;
  606.     FSSpecToDesc(fspec, typeAlias, &fspecDesc);
  607.     
  608.     osstat = SendDirectAppleEventWithArg(FETCH_APP_SIGNATURE, kAEFetchSuite, kAEPutIntoEvent, 
  609.                             &urlDesc,
  610.                             kAEFetchPutIntoItemsParam, &fspecDesc,
  611.                             nil, idleUPP);
  612. exit:
  613.     DisposeDesc(&urlDesc);
  614.     DisposeDesc(&fspecDesc);
  615.     return osstat;
  616. } // FetchPut()
  617.  
  618. /*
  619.  * FetchGet() --
  620.  *    Tell Fetch to download a file or folder from a URL to a folder
  621.  */
  622. OSErr FetchGet(char *url, FSSpec *fspec, AEIdleUPP idleUPP)
  623. {
  624.     AEDesc        nullDesc;
  625.     AEDesc        aerDesc;
  626.     AEDesc        insertLocDesc;
  627.     AEDesc        fspecDesc;
  628.     AEDesc        urlDesc;
  629.     DescType    positionCode;
  630.     OSErr        osstat;
  631.  
  632.     InitDesc(&nullDesc);
  633.     InitDesc(&aerDesc);
  634.     InitDesc(&insertLocDesc);
  635.     InitDesc(&fspecDesc);
  636.     InitDesc(&urlDesc);
  637.     osstat = noErr;
  638.     
  639.     /* first get Ospec for target folder */
  640.     FSSpecToDesc(fspec, typeAlias, &fspecDesc);
  641.     
  642.     /* next build insertion location ("Beginning of alias foo") */
  643.     osstat = AECreateList(nil, 0, true, &aerDesc);
  644.     if (osstat != noErr)
  645.         goto exit;
  646.         
  647.     /* add object-in-relation-to field */
  648.     osstat = AEPutKeyDesc(&aerDesc, keyAEObject, &fspecDesc);
  649.     if (osstat != noErr)
  650.         goto exit;
  651.         
  652.     /* add positioning field */
  653.     positionCode = kAEBeginning;
  654.     osstat = AEPutKeyPtr(&aerDesc, keyAEPosition, typeEnumerated, &positionCode,
  655.                 sizeof(positionCode));
  656.     if (osstat != noErr)
  657.         goto exit;
  658.         
  659.     /* coerce to typeInsertionLoc */
  660.     osstat = AECoerceDesc(&aerDesc, typeInsertionLoc, &insertLocDesc);
  661.     if (osstat != noErr)
  662.         goto exit;
  663.         
  664.     /* create Ospec for item to get */
  665.     osstat = CreateFormNameOSpec(url, cURL, nil, &urlDesc);
  666.     if (osstat != noErr)
  667.         goto exit;
  668.         
  669.     /* now send the event */
  670.     osstat = SendMoveCloneAppleEvent(FETCH_APP_SIGNATURE, kAEClone, &urlDesc, 
  671.                         &insertLocDesc, nil, idleUPP);
  672.     
  673. exit:    /* clean up */
  674.     DisposeDesc(&nullDesc);
  675.     DisposeDesc(&aerDesc);
  676.     DisposeDesc(&insertLocDesc);
  677.     DisposeDesc(&urlDesc);
  678.     DisposeDesc(&fspecDesc);
  679.     return osstat;
  680. } // FetchGet()
  681.  
  682. /*
  683.  * FetchViewFile() --
  684.  *    Tell Fetch to view a file (specified by a URL).
  685.  */
  686. OSErr FetchViewFile(char *url, AEIdleUPP idleUPP)
  687. {
  688.     AEDesc    urlDesc;
  689.     OSErr    osstat = noErr;
  690.     
  691.     InitDesc(&urlDesc);
  692.     osstat = CreateFormNameOSpec(url, cURL, nil, &urlDesc);
  693.     if (osstat == noErr)
  694.         osstat = SendDirectAppleEvent(FETCH_APP_SIGNATURE, kAEFetchSuite, kAEViewFileEvent, 
  695.                         &urlDesc, nil, idleUPP);
  696.     DisposeDesc(&urlDesc);
  697.     return osstat;
  698. } // FetchViewFile()
  699.  
  700. /*
  701.  * FetchItemExists() --
  702.  *    Ask Fetch whether a file (or directory) is included in the frontmost transfer window file list.
  703.  */
  704. OSErr FetchItemExists(char *fname, Boolean *exists, AEIdleUPP idleUPP)
  705. {
  706.     AppleEvent    aereply;
  707.     AEDesc        fnameDesc;
  708.     AEDesc        replyDesc;
  709.     OSErr        osstat = noErr;
  710.     
  711.     InitDesc(&aereply);
  712.     InitDesc(&fnameDesc);
  713.     InitDesc(&replyDesc);
  714.     
  715.     osstat = CreateFormNameOSpec(fname, cHostItem, nil, &fnameDesc);
  716.     if (osstat != noErr)
  717.         goto exit;
  718.     
  719.     osstat = SendDirectAppleEvent(FETCH_APP_SIGNATURE, kAECoreSuite, kAEDoObjectsExist, 
  720.                         &fnameDesc, &aereply, idleUPP);
  721.     if (osstat != noErr)
  722.         goto exit;
  723.         
  724.     osstat = AEGetParamDesc(&aereply, keyAEResult, typeBoolean, &replyDesc);
  725.     if (osstat != noErr)
  726.         goto exit;
  727.     
  728.     *exists = **replyDesc.dataHandle != 0;
  729.     
  730. exit:
  731.     DisposeDesc(&aereply);
  732.     DisposeDesc(&fnameDesc);
  733.     DisposeDesc(&replyDesc);
  734.     return osstat;
  735. } // FetchItemExists()
  736.  
  737. /*
  738.  * FetchRenameItem() --
  739.  *    Rename an item in the frontmost transfer window file list.
  740.  */
  741. OSErr FetchRenameItem(char *oldname, char *newname, AEIdleUPP idleUPP)
  742. {
  743.     AEDesc        itemDesc;
  744.     AEDesc        propDesc;
  745.     AEDesc        newnameDesc;
  746.     OSErr        osstat = noErr;
  747.     
  748.     InitDesc(&itemDesc);
  749.     InitDesc(&propDesc);
  750.     InitDesc(&newnameDesc);
  751.     
  752.     /* create ospec for name of named item */
  753.     osstat = CreateFormNameOSpec(oldname, cHostItem, nil, &itemDesc);
  754.     if (osstat != noErr)
  755.         goto exit;
  756.         
  757.     osstat = CreatePropertyOSpec(pName, &itemDesc, &propDesc);
  758.     if (osstat != noErr)
  759.         goto exit;
  760.         
  761.     /* create desc for new name */
  762.     CStringToDesc(newname, typeChar, &newnameDesc);
  763.     
  764.     /* send the event */
  765.     osstat = SendDirectAppleEventWithArg(FETCH_APP_SIGNATURE, kAECoreSuite, kAESetData, 
  766.                         &propDesc, keyAEData, &newnameDesc, nil, idleUPP);
  767.     if (osstat != noErr)
  768.         goto exit;
  769.     
  770. exit:
  771.     DisposeDesc(&itemDesc);
  772.     DisposeDesc(&propDesc);
  773.     DisposeDesc(&newnameDesc);
  774.     return osstat;
  775. } // FetchRenameItem()
  776.  
  777. /*
  778.  * FetchCreateDirectory() --
  779.  *    Tell Fetch to create a directory (in the frontmost transfer window).
  780.  */
  781. OSErr FetchCreateDirectory(char *dirname, AEIdleUPP idleUPP)
  782. {
  783.     AEDesc        nullDesc;
  784.     AEDesc        aerDesc;
  785.     AEDesc        insertLocDesc;
  786.     AEDesc        propDesc;
  787.     DescType    positionCode;
  788.     OSErr        osstat;
  789.  
  790.     InitDesc(&nullDesc);
  791.     InitDesc(&aerDesc);
  792.     InitDesc(&insertLocDesc);
  793.     InitDesc(&propDesc);
  794.     osstat = noErr;
  795.     
  796.     /* first build insertion location ("Beginning of null container") */
  797.     /* NOTE: null container equals the front window in this case */
  798.     osstat = AECreateList(nil, 0, true, &aerDesc);
  799.     if (osstat != noErr)
  800.         goto exit;
  801.         
  802.     /* add object-in-relation-to field */
  803.     osstat = AEPutKeyDesc(&aerDesc, keyAEObject, &nullDesc);
  804.     if (osstat != noErr)
  805.         goto exit;
  806.         
  807.     /* add positioning field */
  808.     positionCode = kAEBeginning;
  809.     osstat = AEPutKeyPtr(&aerDesc, keyAEPosition, typeEnumerated, &positionCode,
  810.                 sizeof(positionCode));
  811.     if (osstat != noErr)
  812.         goto exit;
  813.         
  814.     /* coerce to typeInsertionLoc */
  815.     osstat = AECoerceDesc(&aerDesc, typeInsertionLoc, &insertLocDesc);
  816.     if (osstat != noErr)
  817.         goto exit;
  818.         
  819.     /* build initial property data */
  820.     osstat = AECreateList(nil, 0, true, &propDesc);
  821.     if (osstat != noErr)
  822.         goto exit;
  823.             
  824.     /* add dir name (can't create dir without it) */
  825.     osstat = AEPutKeyPtr(&propDesc, pName, typeChar, dirname, strlen(dirname));
  826.     if (osstat != noErr)
  827.         goto exit;
  828.  
  829.     /* now send the event */
  830.     osstat = SendCreateAppleEvent(FETCH_APP_SIGNATURE, cHostDirectory, 
  831.                         &insertLocDesc, nil, &propDesc, nil, idleUPP);
  832.     
  833. exit:    /* clean up */
  834.     DisposeDesc(&nullDesc);
  835.     DisposeDesc(&aerDesc);
  836.     DisposeDesc(&insertLocDesc);
  837.     DisposeDesc(&propDesc);
  838.     return osstat;
  839. } // FetchCreateDirectory()
  840.  
  841. /*
  842.  * FetchSendCommand() --
  843.  *    Tell Fetch to send a custom command (or CR-delimited list of commands)
  844.  *    to a URL (i.e. connect to the URL, then send the commands).
  845.  */
  846. OSErr FetchSendCommand(char *cmd, char *url, AEIdleUPP idleUPP)
  847. {
  848.     AEDesc    urlDesc;
  849.     AEDesc    cmdDesc;
  850.     OSErr    osstat = noErr;
  851.     
  852.     InitDesc(&urlDesc);
  853.     InitDesc(&cmdDesc);
  854.     
  855.     osstat = CreateFormNameOSpec(url, cURL, nil, &urlDesc);
  856.     if (osstat != noErr)
  857.         goto exit;
  858.     CStringToDesc(cmd, typeChar, &cmdDesc);
  859.     
  860.     osstat = SendDirectAppleEventWithArg(FETCH_APP_SIGNATURE, kAEFetchSuite, kAESendFTPCommandEvent, 
  861.                             &urlDesc,
  862.                             kAEFetchSendFTPCommandsParam, &cmdDesc,
  863.                             nil, idleUPP);
  864. exit:
  865.     DisposeDesc(&urlDesc);
  866.     DisposeDesc(&cmdDesc);
  867.     return osstat;
  868. } // FetchSendCommand()
  869.  
  870. /*
  871.  * FetchGetPreference() --
  872.  *    Get an arbitrary Fetch preference.
  873.  */
  874. OSErr FetchGetPreference(DescType propCode, AEDesc *valueDesc, AEIdleUPP idleUPP)
  875. {
  876.     AppleEvent    aereply;
  877.     AEDesc        nullDesc;
  878.     AEDesc        propDesc;
  879.     OSErr        osstat = noErr;
  880.     
  881.     InitDesc(&aereply);
  882.     InitDesc(&nullDesc);
  883.     InitDesc(&propDesc);
  884.     
  885.     /* create ospec for application object property (app object == null) */
  886.     osstat = CreatePropertyOSpec(propCode, &nullDesc, &propDesc);
  887.     if (osstat != noErr)
  888.         goto exit;
  889.         
  890.     /* send the event */
  891.     osstat = SendDirectAppleEvent(FETCH_APP_SIGNATURE, kAECoreSuite, kAEGetData, 
  892.                         &propDesc, &aereply, idleUPP);
  893.     if (osstat != noErr)
  894.         goto exit;
  895.         
  896.     osstat = AEGetParamDesc(&aereply, keyAEResult, typeWildCard, valueDesc);
  897.     if (osstat != noErr)
  898.         goto exit;
  899.         
  900. exit:
  901.     DisposeDesc(&aereply);
  902.     DisposeDesc(&nullDesc);
  903.     DisposeDesc(&propDesc);
  904.     return osstat;
  905. } // FetchGetPreference()
  906.  
  907. /*
  908.  * FetchSetPreference() --
  909.  *    Set an arbitrary Fetch preference.
  910.  */
  911. OSErr FetchSetPreference(DescType propCode, AEDesc *valueDesc, AEIdleUPP idleUPP)
  912. {
  913.     AEDesc        nullDesc;
  914.     AEDesc        propDesc;
  915.     OSErr        osstat = noErr;
  916.     
  917.     InitDesc(&nullDesc);
  918.     InitDesc(&propDesc);
  919.     
  920.     /* create ospec for application object property (app object == null) */
  921.     osstat = CreatePropertyOSpec(propCode, &nullDesc, &propDesc);
  922.     if (osstat != noErr)
  923.         goto exit;
  924.         
  925.     /* send the event */
  926.     osstat = SendDirectAppleEventWithArg(FETCH_APP_SIGNATURE, kAECoreSuite, kAESetData, 
  927.                         &propDesc, keyAEData, valueDesc, nil, idleUPP);
  928.     if (osstat != noErr)
  929.         goto exit;
  930.     
  931. exit:
  932.     DisposeDesc(&nullDesc);
  933.     DisposeDesc(&propDesc);
  934.     return osstat;
  935. } // FetchSetPreference()
  936.  
  937.